Remove mention of 'declarative' schema changer' #19443
Conversation
✅ Deploy Preview for cockroachdb-api-docs canceled.
|
✅ Deploy Preview for cockroachdb-interactivetutorials-docs canceled.
|
|
this PR comes out of a convo with Dikshant re: us maintaining lists of "which statement is done by the DSC" is not really helpful for users and is more of an internal detail that is leaking out IMO the PR only removes 'declarative schema changer' stuff from prose, it does not remove the documentation for the variable that controls on/off it also removes the whole "list of which statements" which, as a user, it's not clear what that list is for or why i should care other than "it's magically better somehow" which feels very internal to the team/CRL support, not user-facing also it only changes v25.1 for our review, once we're happy with this change i will backport this change to earlier versions. If you have opinions about which earlier versions we should/should not make this change to, i'm def open to that. i was thinking v23.1+ but please let me know |
✅ Netlify Preview
To edit notification comments on pull requests, go to your Netlify site configuration. |
Fixes DOC-8693 Summary: - Remove mentions of "declarative schema changer" (DSC) for the following reasons: - 1. It is enabled by default, and 99% of users will never change the relevant setting or even need to know what that is. - 2. Its existence is an internal implementation detail that is fine for internal TSE runbooks to refer to, but should not really be in customer-facing docs since "it uses two different implementations on the inside, one of which we're migrating away from" should not be a thing that matters to 99% of users unless there is a specific problem they are working with TSE to solve.
rmloveland
force-pushed
the
20250310-DOC-8693-remove-declarative-schema-changer
branch
from
f3394f5 to
9c5ecfe
Compare
rmloveland
deleted the
20250310-DOC-8693-remove-declarative-schema-changer
branch
|
I'm a nobody, Normie user. Honestly, I was reading this doc before this change, and after moving to 25.1 some of my migrations were failing(in a local dev machine tbh, since in prod they're already applied), and that section in the docs helped me understand better what was going on and what I would need to change to my system and/or enable or disable in my cluster. I think it's helpful to be kept in there.
I was getting this error and with that text in there I was able to find the information, read it and understand. With this removal, I feel like for users like me, who might go through a similar issue, it will be harder for them to figure out what went wrong. Once you have fully migrated to DSC, it might not matter as a term as much, but as you're in the process of migrating to it, and some issues will arise for some users, it's important and helpful for them to know. I'm gonna keep reading the docs in the wayback machine. If you're curious how this information helped me, read this comment: prisma/prisma#26864 (comment) |
Fixes DOC-8693
Summary:
Remove mentions of "declarative schema changer" (DSC) for the following reasons:
It is enabled by default, and 99% of users will never change the relevant setting or even need to know what that is.
Its existence is an internal implementation detail that is fine for internal TSE runbooks to refer to, but should not really be in customer-facing docs since "it uses two different implementations on the inside, one of which we're migrating away from" should not be a thing that matters to 99% of users unless there is a specific problem they are working with TSE to solve.